home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 1.toast / Sample Code / Networking / MoreAutoPush / Read Me About MoreAutoPush < prev   
Encoding:
Text File  |  2000-10-06  |  2.9 KB  |  62 lines  |  [TEXT/ttxt]
  1. Read Me About AutoPush
  2.  
  3. 1.0b1
  4.  
  5. This sample serves two purposes: it contains a sample code library that simplifies access to the STREAMS "sad" (autopush) driver, and it includes a program that you can use to establish arbitrary autopushes for testing purposes.
  6.  
  7. This sample requires some form of Open Transport.  Only a PowerPC build is provided, although the concepts are supported on 68K versions of OT.
  8.  
  9. Packing List
  10.  
  11. The sample contains the following items:
  12.  
  13. • Read Me About MoreAutoPush — This document.
  14.  
  15. • MoreSetup.h — This sample was projected out of the DTS sample code library MoreIsBetter.  This setup file is common to all MIB modules and is required to build the sample.
  16.  
  17.   <http://developer.apple.com/samplecode/Sample_Code/Overview/MoreIsBetter.htm>
  18.  
  19. • MoreAutoPush.h — The interface to the autopush library.
  20.  
  21. • MoreAutoPush.c — The implementation of the autopush library.
  22.  
  23. • MoreAutoPushTest — This folder contains the source and compiled binary (MoreAutoPushTest-PPC) of a program to test the autopush library.  This program is also a useful utility for autopush testing in general.
  24.  
  25. Using the Sample
  26.  
  27. To run the “MoreAutoPushTest-PPC” application, simply launch it from the Finder.  The application prints a list of possible commands.  Enter a command to execute it.  For example, to autopush the "StreamNOP" module on top of the "serial1" driver, enter the "p" command and follow the onscreen instructions.
  28.  
  29. Note: StreamNOP is a "no operation" STREAMS module that is available from the DTS sample code web site.
  30.  
  31.   <http://developer.apple.com/samplecode/Sample_Code/Networking/StreamNOP.htm>
  32.  
  33. To use the library in your own code, simply add the “MoreAutoPush.c” file to your project and include the “MoreAutoPush.h” header.  The header includes documentation on each of the routines.  There is more documentation in “Open Transport Advanced Client Programming” (see below).
  34.  
  35. Building the Sample
  36.  
  37. This sample was built using the CodeWarrior Pro 2 C compiler, upgrade to Universal Interfaces 3.3.2.  There should be no problem building the project using a modern CodeWarrior compiler.  Just open the “MoreAutoPushTest.mcp” project, select the “PPC” target, and choose Make from the Project menu.
  38.  
  39. How it Works
  40.  
  41. The STREAMS autopush driver ("sad") is described in detail in “Open Transport Advanced Client Programming”.  This code was developed as part of writing that book.  See chapter 8 of that book for more details on this library.
  42.  
  43.   <http://developer.apple.com/macos/opentransport/OTAdvancedClientProg/
  44.    StandardModules.html>
  45.  
  46. Caveats
  47.  
  48. Mac OS X does not support the STREAMS architecture, and hence does not support this particular type of autopush.
  49.  
  50. Credits and Version History
  51.  
  52. If you find any problems with this sample, mail <DTS@apple.com> and I’ll try to fix them up.
  53.  
  54. 1.0b1 (Oct 2000) was the first version officially released as a sample.
  55.  
  56. Share and Enjoy.
  57.  
  58. Apple Developer Technical Support
  59. Networking, Communications, Hardware
  60.  
  61. 5 Oct 2000
  62.